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(54) Method for controlling a network element from a remote workstation 



(57) A method is provided for controlling a network 
element from a client at a remote work station connect - 
able to the network, the network, element is registered 



for attributes to be tracked, and attributes associated 
with the network element are polled only if the client re- 
quests the monitoring of the network element. 
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Description 

Background Of The Invention 

[0001] This invention relates, generally, to a method for controlling a network element and, more particularly, to a 
method for remotely controlling the network by communications through the network. 

[0002] Network management systems in which network elements, or management agents, are remotely controlled 
from a remote, management work station by means of communications between the management work station and 
the managed network elements sent through the network are known. Such known network management systems 
employ a special communication protocol for communications between the remote work station running a management 
program and an element management server that contains a management information base that defines the interface 
between the work station and the network elements. 

[0003] Known systems such as (Hewlett Packard HP-OV NNM or DM, Sun Microsystems Solstice) present an in- 
terface where the client application must poll the network element when status is needed. In these systems, the polling 
may not be coordinated and is replicated for each client, if each client is interested in the same attributes. Also, each 
of the clients receive the lull results for each polling cycle (even if there was no change from the last cycle), increasing 
the bandwidth used to communicate between the client application and the network element, as well as creating ad- 
ditional processing overhead due to the replicated polling at the network element. 

Summary Of The Invention 

[0004] A method is provided for controlling a network element from a remote work station connectable to the network. 
The method provides for registering the network element for attributes to be tracked, and polling for attributes associated 
with the network element only if the client requests the monitoring of the network element. Changes in attributes are 
reported when the client requests notification of changes in attributes. For attributes polled for a plurality of clients, 
changes in the attributes to one of the plurality of clients requesting notification of changes in the attributes are reported. 
[0005] The method further provides for polling once for a plurality of clients that registers for the same attributes and 
reporting asynchronously changes in the attributes to a plurality of clients. 

[0006] Another aspect of the invention provides for running an object oriented program at the remote work station 
to control an object associated with the controllable network element, translating interface operations generated by 
the work station during the running of the object oriented program to corresponding translated interface operations in 
an object oriented language associated with the object being controlled, and connecting the corresponding translated 
interface operations through the network to an object server to control the object associated with the network element 
in accordance with the translated interface operations. 

[0007] These and other features and advantages of the present invention will become apparent from the following 
detailed description, the accompanying drawings and the appended claims. 

Brief Description Of The Drawings 

[0008] The foregoing advantageous features will be described in detail and other advantageous features of the in- 
vention will be made apparent from the detailed description of the preferred embodiment of the invention that is given 
with reference to the several figures of the drawings, in which: 

Fig. 1 is a functional block diagram of the preferred embodiment of a management system using the preferred 
network element control method of the present invention; 

Fig 2 is a functional block diagram of the preferred embodiment of the translating interface shown as a single 
functional block in Fig. 1; 

Fig. 3 is a functional block diagram illustrating the interface with the controlled network element that is visible to 
object oriented client management application at the work station of Fig.1; 

Fig. 4 is a table of a plurality of service objects that interact with the client management application run at the work 
station of Fig.1; 

Fig. 5 is a table of a plurality of call back functions performed at the translating interface of Fig.2; 

Fig. 6 is a table of the different fundamental data types capable of being translated by the translating interface of 
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Ftg.2 in accordance with the invention. 

Fig. 7 is a block diagram showing the relationship between client application-specific service object, and the internal 
service representative of managed object instances; 

5 

Fig. 8 is a table summarizing filter criteria that is valid for each event category; and 

Fig. 9 is a table defining specific exceptions with an EMAPI exception code containing one of the listed values. 
70 Detailed Description 

[0009] This invention provides an application programming interface (API) and protocol that provides for efficient 
communication between a distributed client application and an element management server independent of the com- 
munication protocol to the network element. The Element Management Application Programming Interlace (EMAPI) 

is provides the following benefits over known management system. The invention has application in the management of 
a telecommunication network element. For more information regarding such a management of a telecommunication 
network element refer to commonly owned U. S. patent application serial number 09/088,463, entitled "Method for 
Computer Internet Remote Management of a Telecommunication Network Element" by William E. Barker, Lisa M. 
Connelly, Marvin A. Eggert, Michael P. Foley, Kenneth R. Macfarlane, Philip M. Parsons, Girish Rai, Jerome E. Rog, 

20 and Kurt A. Vangsness, filed on May 31 , 1 998, the disclosure of which is hereby incorporated by reference. 

• Efficient use over low bandwidth connections. Client applications register for network element information they 
wish to track and after an initial set of data only receive incremental updates (deltas) when there are changes. 

25 • Centralized polling of attributes. Attributes are only polled if a client exists that has registered to monitor the attribute. 

If multiple clients register for the same attribute(s), the polling is not repeated for the clients-only a single polling 
cycle is performed. 

[0010] The invention is used in an operations, administration and maintenance system 20 as shown in Fig. 1. The 
30 system 20 includes a PC or workstation 22, an element management server (EMS) 24, an interface in accordance with 
the invention 26, located between the workstation 22 and an object server 25. An application processor 28 is connected 
to the element management server 24. 

[0011] The workstation 22 includes a web browser 30 which is the interface to the client and is a host for JAVA applets 
32 and web browser HTML 35 which is a hypertext markup language. 
35 [001 2] The system 20 operates on a cluster computing environment, and leverages off-the-shelf technology to enable 
additional customers visible features, while extending to subsequent releases and other projects, with minimal in- 
creased cost. System 20 is provided through the web browser interface and a SNMP based element management 
platform. 

[0013] A client executes applications via web pages at the workstation 22. The client makes requests for various 

40 views of the network status by making selections through the web browser 30. The web browser requests pages from 
the web server 28 which transmits HTML pages that contain instructions to load and run the appropriate JAVA applet 
32. One the applet starts, it communicates with the object server 25 through the interface 26 to perform initialization 
and to request initial configuration and status information that is appropriate for the current requested view The JAVA 
applet 32 then registers with the object server 25 for subsequent notifications of changes to configuration and status 

45 that it requires to keep the view up to date. The client may perform commands to request various maintenance oper- 
ations on the network element 28. These commands are converted into appropriate requests through the interface 26 
and perform operations on the object server 25. The commands are then translated into SNMP and are transmitted to 
the network element 28 through the SNMP library 33. Acknowledgements and command responses from the network 
element 28 are transmitted through the SNMP library 33, are converted to events by the object server 25 and transmitted 

so to originating JAVA applet 32 through the use of callbacks defined by the interface 26. 

[0014] In one embodiment of the invention, as shown in Fig. 3, client applications in JAVA applets 32 include an 
active alarm list browser, a system alarm survey and a network element detailed status display. Client applications 
communication with the web server 28 via the interface 26 in accordance with the invention, to the element manager 
through a distributed object request architecture such as CORBA. The interface 26 provides a constant interface to all 

55 managed objects in the network, and hides the implementation details associated with the element manager platform. 
[001 5] The interface 26 (EMAPI) is the definition of objects, attributes and operations that comprise the protocol used 
between client applications and the server to manage network elements. The EMAPI uses the industry standard COR- 
BA to provide distribution of the objects and their operations and to allow for the implementation of the client and server 
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to be in different programming languages and on different computer architectures. 

[001 6] The client interface to the server and the managed object attributes is described in the interface 26 and man- 
aged object notation provides a consistent model of all managed objects in the network, hiding the implementation 
details associated with the element manager platform from client applications, thus clients do not need to know the 

5 underlying protocol to the network elements. Managed objects specific logic is encapsulated within the managed object 
instead of scattered throughout various applications thus simplifying client application development. 
[001 7] Each physical, selected non-physical and logical component in the network is modeled as a managed object, 
which the Server makes visible to distributed client applications through the facilities of the Common Object Request 
Broker Architecture (CORBA). EM clients need only be concerned about the attributes and operations defined for each 

10 application managed object, and not the details of network-level protocol and the server infrastructure required to 
support object services. 

EMAPI Object Definition 

is [0018] Fig. 3 illustrates all of the interfaces visible to client applications which does not depict process or processor 
boundaries, which are made transparent by the client and server object request brokers (ORBs). Application services 
are provided through object interlaces formally defined in the CORBA Interface Definition Language (IDL). The IDL 
specification of the interfaces described in this document is provided in the Appendix A. 

[0019] The service objects resident on the server with which client applications will interact are shown in Fig. 4. 
20 [0020] Client applications which register for real-time status updates or notification of events, alarms or configuration 
changes must provide a reference to a local callback object which the server will use to propagate information asyn- 
chronously. The callback interfaces defined in the interface 26 are shown in Fig. 5. Classes which implement these 
interfaces must be defined and instantiated in client code. 

25 Data Representation 

[0021] There are several fundamental data types defined in the interlace 26, which fall into one of the two categories 
shown in Fig. 6. 

30 Session Management 

[0022] Each EM client session is logically associated with a unique login -host combination. Multiple client applications 
may be associated with the same session, though only one need be registered for the session to be considered active. 
Session and application identifiers are assigned by the User Session Manager to track resources used by the client, 

35 and in future releases, to correlate client access permissions with operation requests. Applications may or may not 
cross process boundaries. For example, multiple instances of the EMS Command Line Interface (CLI) application 
registered with the same login and host name will share the same session id, but each process is associated with a 
different application id. In the EMS Graphical User Interface, all application frames execute in the same process space 
(albeit in different Threads), yet each frame is associated with a distinct application id. Note that each client application 

40 js required to independently register a periodic heartbeat to validate for the Server that its associated resources are 
still needed. 

[0023] The UserSession service object provides the following interfaces: 
• start Application 

45 This method must be invoked for each client application initialization. 

stopApplication 

A client invokes this method to notify the Server that a target application is terminating, and its associated 
resources should be released. 



so 



55 



• stop 

This method may be used to deregister all applications associated with the same session identifier. 

• heartbeat 

[0024] This method must be invoked at least every UserSession: :HeartbeatPeriod seconds to avoid a timeout con- 
dition which, when detected by a Server audit, will result in the release of all resources utilized by an application. 
[0025] Refer to the description of interface UserSession in the attachment for additional details. 



4 



BNSDOCID: <EP 099S076A1 I > 



EP 0 998 076 A1 



Managed Objects 

[0026] A managed object (MO) is an abstract representation of a physical or logical resource which may be managed 
by the EMS, such as a network element, maintenance unit or data link. The EM Server will implement one application- 

5 specific service object for each type of physical or logical resource to be managed. Each of these service objects 
defines a set of attributes which identify managed object properties, as well as the operations which may be performed 
on a specified managed object instance. (The decision to provide access to instance information through a single 
"service object" stems from the fact that current ORB implementations become unstable when managing very large 
numbers of remote references.) Fig. 7 depicts the relationship between Client, application-specific service object, and 

io the internal Server representation of managed object instances. 

[0027] Each managed object service class is uniquely identified by a ClassCode. Each managed object instance is 
uniquely identified by an Instld. Any object instance in the system may be uniquely referenced by a managed object 
identifier (Oid), which is the combination of ClassCode and Instld. 

[0028] Managed object status information is reported by a service object as a sequence of attribute code-value pairs. ■ 
is Each attribute value is defined as a union of all of the interlace 26 fundamental data types described in Fig. 6. 

[0029] Configuration information is reported as a sequence of ConfigData structures, which are defined to contain: 

• network element instance id 
20 • managed object instance id 

• a managed object key list reported as a sequence of attribute-value pairs- when length is greater than 0, the key 
list specifies the associated logical identifiers (Logicallds) 

25 [0030] Each managed object service class must implement the MO interface, which defines the following configu- 
ration and status services: 

• viewConfig 

A client uses this method to obtain the current EMS view of the managed object configuration for a specified 
30 network element instance. Note that the reserved instance identifier Anylnstance may be used to obtain configu- 

ration information for all network elements. 

• notifyConfig 

A client may also register for an initial view of managed object configuration information and notification of 
35 subsequent changes via callback. The initial view is returned with a notification type CONFIGJNIT Subsequent 

changes are reported with type CONFIG_CREATE or CONFIG_DELETE. 

• cancel Notify 

A client uses this method to cancel registration for managed object configuration notifications associated with 
40 a specified client application. 

• getPersistent 

A client may use this method to retrieve the set of attribute codes (SeqAttrCode) identifying all "persistent" 
data maintained by this service object. Values for persistent attributes of each managed object instance are stored 
45 and kept current irrespective of any client requests. 

• getAttrSpec 

A client may use this method to retrieve the name and codes of all attributes defined for a target service class 
(currently used for debugging only). 

so 

• getKeySpec 

A client may use this method to retrieve the set of codes (SeqAttrCode) identifying the attribute^) which 
represents the logical identifier(s) of any instance of the target class. 

55 • viewStatus 

A client may invoke this method to obtain the EMS view of the current values for a specified set of persistent 
attributes for a specified managed object instance. 
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• get Status 

A client may use this method to register for a snapshot of current status information. This interface differs from 
the previous one in that the requested attribute list may specify any managed object attribute codes-not just those 
associated with persistent data, and the information is returned via client status callback (StatusCB). 

• startUpdate 

A client may also register for an initial view and notification of any updates to a list of selected attributes for a 
specified managed object instance. In this case, an initial view is reported via client callback with a notification 
type STATUSJ NIT. Subsequent changes are reported with type STATU S_CHANGE. Note that managed object 
instance deletions are reported only through configuration change notification to avoid a potential flurry of client 
status callbacks when a network element is unequipped. 



* stopUpdate 

A client uses this method to cancel registration for managed object status updates associated with a specified 
client application. 

• getlnst 

A client may use this method to obtain a managed object instance identifier for a specified network element 
instance id and managed object key list. 

[0031] Note that each method requires a client session application identifier (SessionAppId) to validate user access. 
In the case of configuration or status change notification registration, this identifier is also used to keep track of the 
additional server resources utilized while the client application is active. 

[0032] Refer to the description of interfaces MO, ConfigCB & StatusCB in the attachment for additional details. 
Network Element Level Managed Objects 



[0033] Each network-element level managed object must also implement the NEMO interface which defines addi- 
tional network-element level configuration services: 

30 

viewNEconfig 



[0034] A client may invoke this method to obtain the current EMS view of the network element configuration. 
35 • notifyNEconfig 

A client may also register for an initial view of network element-level managed object configuration information 
and notification of subsequent changes via callback. The initial view is returned with a notification type 
CONFIGJNIT. Subsequent changes are reported with type CONFIG_CREATE or CONFIG_DELETE. 

40 ♦ cancel NE notify 

A client application should use this method to cancel registration for network element managed object config- 
uration updates. 

• getNEinst 

45 A client may invoke this method to retrieve the NEMO instance identifier of the network element associated 

with a specified logical id. 

• getLogicalld 

A client may invoke this method to retrieve the logical identifier of the network element associated with a 
50 specified NEMO instance id. 

• getContainment 

A client may invoke this method to obtain a sequence of containment information for the target NEMO, where 
each entry in the sequence contains the name, class code and CORBA reference to a contained service class 
55 object. 

[0035] Note that each method requires a client session application identifier to validate user access. In the case of 
configuration change notification registration, this identifier is also used to keep track of the additional server resources 
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utilized while the client application is active. 

[0036] Refer to the description of interfaces NEMO & NEconfigCB in the attachment for additional details. 
Descriptive Entity Objects 

5 

[0037] Application objects of this type are defined to provide type and attribute information for abstract entities, such 
as data communicated between the EMS and network elements which are not part of a managed object description 
(e.g. SNMP trap definitions and command groups). Descriptive entity objects provide no implementation-they are de- 
fined in application-specific IDL and known by client applications at compile time. 

10 

Event Distributor 

[0038] An event is reported as a combination of the following: 
15 1. A header, which contains information of most general interest: 

• Time of the event 

• Event category defined to be one of the following: 

20 

* Alarm Set 

* Alarm Clear 

25 * Command Acknowledgment 

* Command Response 

* Configuration Change 

30 

* Informational Message 

* Initialization 
35 * State Change 

• Network element object identifier 

• Network element alarm level-meaningful only for alarm set 

40 

• Maintenance unit object identifier (if applicable) 

• Maintenance unit alarm level-meaningful only for alarm set 

45 • A command identifier (Cmdld) defined as a user session id & command sequence number^neaningf ul 

only for command acknowledgment & response 

1 . Event data defined as a sequence of structures which contain: 

so • A ClassCode of a managed object, network element or descriptive entity 

• A sequence of attribute code-value pairs 

[0039] Client applications may request a copy of the event stream, as processed by the event distributor, filtered on 
55 information specified in the event header Filter wildcards are implemented with 'out-cf-band' values: 

• Any Category 
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Any Class 
Any Instance 



5 • Any Alarm 
• Any Cmd 



[0040] The table in Fig. 8 summarizes which filter criteria are valid for each event category: 

[0041] The event distributor processes filters by examining the specified category and AND'ing together valid criteria. 

Clients may simulate OR operations by registering multiple filters. 

[0042] The EvtDist service object implements the following client interfaces: 

• RegisterFilter 

A client uses this method to register an event filter. A filter identifier is returned. 



• CancelFilter 

A client invokes this method to remove a specified event filter, using the filter id returned from the associated 
registration. 

20 

[0043] Note that each method requires a client session application identifier to validate user access. 
[0044] Refer to the description of interfaces EvtDist & EventCB in the attachment for additional details. 

Alarm Manager 

25 

[0045] Alarm information is reported as a sequence of AlarmData structures which contain: 

• The ClassCode of a managed object which defines a network-element specific alarm record. 

Note that in the first release of the EMS, only one network element active alarm table is defined (ApAc- 
30 tive Alarms). 

• A sequence of alarm records, each of which contains an alarm instance identifier and sequence of attribute code- 
value pairs. 

Client applications may request a copy of all active alarms filtered on any combination of the following: 

35 

• Network element 



• Maintenance unit 



40 • Alarm level 

[0046] Similar to the interfaces provided by the event distributor, out-of-band values may be used to represent wild- 
cards. 

[0047] Since managed object instance information may not be available at the time an alarm is reported, the actual 
45 alarm filter criteria are specified in terms of logical identifiers. Logical ids are integer values which represent the logical 
numbers of devices and interfaces (e.g. AP 4). The correlation between logical ids and managed object instance iden- 
tifiers is provided in the configuration information made available by each managed object service object, and through 
the utility method getlnst. Refer to the section on Managed Objects for additional details. 

[0048] The following AlarmManager client interfaces are written specifically for the Active Alarm List application: 

so 

• RequestAlarms 

A client invokes this method to register a filter for active alarms. 



• ChangeFilter 

A client may invoke this method to change filter criteria. 

• RefreshAlarms 

A client may invoke this method to refresh the active alarm list. 
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• CancelAlarms 

A client should invoke this method to de-register a filter. 

[0049] All operations except for de-registration return all active alarms filtered on the specified criteria. Also, each 
5 of these methods requires a valid client session application identifier to validate user access, and to keep track of the 
additional server resources which may be utilized while each client is active. 
[0050] The following Alarm Manager interface may be used by any client application (e.g. CLI): 

• opAlarm 

to Through client implementations of event callbacks used to process command acknowledgements and re- 

sponses (the same EventCB reference may be used in both cases), this method returns either a list of all active 
alarms in the system or just those associated with a target network element. 

[0051] Refer to the description of interfaces AlarmManager, AlarmCB & EventCB in the attachment for additional 
is details. 

Exceptions 

[0052] Exceptions are used for consistent and structured error handling in both the EM Server and Client. 
20 [0053] The CORBA specification defines many system exceptions • 

• BAD_PARAM 
INV_OBJREF 

25 

• NO_PERMISSION 

• BAD_OPERATION 
so . OBJ_AD A PTE R 

• ♦♦♦ 

[0054] Refer to "The Common Object Request Broker Architecture and Specification 0 for an exhaustive list of mne- 
35 monies and the associated exception descriptions. 

[0055] Vendor-specific object request broker exceptions are also defined (using the Minor identifier of the SystemEx- 
ception): 

• NOJT_DAEMON_PORT 

40 

• LICENCE_EXPIRED 

• ♦♦♦ 

45 [0056] Currently, the EMS uses lona's Orbix product. Refer to the "Orbix 2.3c Reference Guide" for an exhaustive 
list of mnemonics and the associated exception descriptions. 

[0057] In most cases, exceptions will be treated as fatal errors by Client code resulting in application termination. 
[0058] An interface 26-specific exception is also defined as an Exception Code containing one of the following values 
shown in Fig. 9. 

so 
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APPENDIX A- Emapi idl 

tfifndef _EMAPI_IDL 
5 #define _EMAPI_IDL 

// 

// File: Emapi . idl 
// 

10 // Description: CORBA IDL file for the Element Manager API. All client 

// visible interfaces that are common to all applications of the 

EMS 

// are described here. 

// 

is 

// interfaces which are referenced before they are defined 
interface ConfigCB; 
interface StatusCB; 
interface NEconfigCB; 
interface EventCB; 
20 interface AlarmCB; 

// some of the more commonly used ASN. 1 standard types 

typedef boolean AsnlBoolean; 

typedef long Asnllnteger; 
25 typedef unsigned long AsnlUInteger ; 

typedef sequence<octet> AsnlOctet; 

typedef unsigned long * AsnlTimeticks ; 

typedef unsigned long AsnlGauge; 

typedef unsigned long AsnlCounter; 
3Q typedef octet AsnllpAddress t 4 ] ; 

typedef octet AsnlNull; 

typedef sequence<unsigned long> AsnlOid; 

// logical identif ier— one or more attributes of this type may be 
35 defined 

// for any managed object to provide a logical identity (e.g. 
application 

// processor number, RCS number) 

typedef Asnllnteger Logicalld; 

typedef sequence<LogicalId> SeqLogicalld; 

40 

// definition of an object identifier 
typedef long ClassCode; 
typedef unsigned long Instld; 

45 struct Oid { 

ClassCode classld; 
Ins.tld. instld; 

1 ; 



50 



// reserved class id 

const ClassCode AnyClass * -1; 



// reserved instance id's 

const Instld Nulllnstance = 0; 

const Instld Anylnstance = 1; 

55 const Instld MaxRsvdlnst = 1; 
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10 



15 



20 



25 



// instance id associated with singleton objects (e.g. System) — note 
that 

// this is the first id normally assigned 

const Instld Singletonlns t = MaxRsvdlnst + 1; 

// reserved logical id 

const Logicalld AnyLogicalld = -1; 

// application identifier 
typedef long Appld; 

// reserved application id's 

const Appld NullAppId = -1; 

const Appld Any Appld = -2 ; 

// application/session identifier 
struct SessionAppId f 

Instld session; 

Appld app; 

I; 

// maximum number of applications active per single user session 

const short MaxSessionApps = 10; 

// command identifier 

typedef long CmdSeqNo; 



// reserved command sequence number 

const CmdSeqNo AnyCmd = -1; 

const CmdSeqNo InvalidCmd = -1; 

struct Cmdld { 

30 Instld session; 

CmdSeqNo seqNo; 

} ; 



// element manager base application programming interface exception 
35 codes 

enum Emapi Except ionCode { 

EM_INVALID_USER, 

EM_UNKNOWN_HOST , 

EMJTOO_MANY_USER_SESSIONS , 

EM_TOO_MANY_AP P LI CATIONS , 
40 EMINVALI D_S ESS I ON_I D , 

EM_I NVALI D_AP P_I D , 

EM_INVALID_IN5T_ID, 

EM_INVALID_Nr_ID f 

EM_INVALID_MO_ID, 
45 EM_INVALID_ATTR_CODE, 
- - EM_NO_MATCHING_INST, 

EM_ I NVALI D_ FILTER , 

EM_INVALID_FILTER_ID, 

EM_NE_ISOLATED, 

EM_INTERNAL_ERROR, 
50 EM_I NVALI D_0 PERAT I ON , 

EM_ACCESS_DENIED, 

EM_VERS 1 0N_MI S MATCH , 

EM_LOST_RESOURCE, 

EM_I NVAL I D_KEY , 
55 EM INVALID CATEGORY 
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75 



// element manager exception 

exception Emapi Exception { EmapiExceptionCode errCode; }; 

5 

// Access permissions: 

// For now, permission is granted on a network element basis: 

// on any kind of access 

/ / on status information access 

10 / / on maintenance operation access 

// The network element basis can be: 

// on any network element 

// Oid: (AnyClass, Anylnstance} 

// on any instance of a particular network element type 

// Oid: {<class>,AnyInstance} 

// on a specific instance of a particular network element 

type 

// Oid: {<class>,<instance>| 

// Kinds of Access (set to be manageable by using a bit map/mask) : 
20 typedef Asnllnteger AccessType; 

const AccessType AnyAccess = -1; 

const AccessType NoAccess = 0; 

const AccessType StatusAccess =» 1; 

const AccessType OperationAccess = 2; 

25 //const AccessType NextAccess s 4; 

//const AccessType AfterThat = 8 

//const AccessType AfterThat = 16 
// ...and so on, in powers of 2 



30 



35 



40 



SO 



55 



// Access Permission structure: 

// accessible TRUE or FALSE for this type of access 

// accessType type of access 

// oid network element involved in this type of 

struct Access Permission { 

boolean accessible; 

AccessType accessType; * 

Oid oid; 

) ; 

// Application registration results in the client's receiving a 
sequence of 

// Access Permission blocks, 

typedef sequence<AccessPermission> SeqAccess Permission; 

struct AccessPermissionList { 

SessionAppId sessionAppId; 
SeqAccess Permission seqAccess Permission; 

} ; 

// user session 
interface UserSession { 
// Null Session 

const Instld NullSession = 0; 
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// maximum number of sessions per system 

const short MaxUser Sessions = 32; 

// heartbeat period in seconds (Applications should use this 

value to 

// time their heartbeats with the server. ) 

const long HeartbeatPeriod = S; 

// client application registration: must be called once per 
io // application. 

// 

// INPUTS: 

// applicationName: determined by client application 

// host: name of host on which client is running 

// user: login id 

// passwd: user's password 

// RETURNS: 

// unique id for this session's application 

// plus a sequence of Access Permission blocks 

// showing what is accessible from this application 

20 // NOTE: The client's responsibility to delete the returned 

pointer 

// 

// THROWS: 

/ / EM_TOO_MANY_SES S IONS 

/ / EM_TOO_MANY_AP P LI CATION S 

AccessPermissionList startAppli cation { 
in string host, 
in string user, 
in string passwd, 
in string applicationName) 
30 raises ( EmapiException) ; 

// client deregistration — entire session 
// 

// INPUT: a session application id 
// 

// THROWS: 
// EM_INVALID_SESSION_ID 

void stop (in Instld sessionld) raises (EmapiException) ; 
// client deregistration — single application 

40 // 

// INPUT: a session application id 
// 

// THROWS: 

// EM_INVAXID_SESSION_ID 
// EM_INVALID_APPLICATION_ID 
_ void stopApplication ( in SessionAppId id) 
raises (EmapiException) ; 



25 



35 



45 



// client heartbeat 
// 

50 // INPUT: session application id 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// EM_I NT ERNAL_ ERROR 
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void heartbeat (in SessionAppId id) raises (EmapiException) ; 



10 



15 



20 



// 

// Managed Object definition. The Managed Object (MO) describes 
definitions 

// and operations that are common to all application specific managed 
// objects in the system. 

// 

interface MO { 

// All attributes of an MO are identified by integer constant 
// codes called AttrCodes. 

typedef long AttrCode; 

const AttrCode NullAttrCode = -1; 

// 

// The following attribute codes are reserved and are used 
//by the MO implementation. Clients should always use the 
// attribute codes found in the application specific managed 
// object definition (e.g. ApModule. idl) and not these. 
// 

const AttrCode moInstanceCode = 0; 

const AttrCode nelnstanceCode = 1; 

const AttrCode LastReservedCode= 1; 



25 



// clients register for updates by specifying a sequence of 
// attribute codes 

typedef sequence<AttrCode> SeqAttrCode; 



30 



35 



40 



// The atrribute value is a discriminated union of scalars 
// All basic types currently supported by the EMS are 
described 



// here, 
typedef long 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType 
const AttrType' 



AttrType; 

Vallnstld 

ValAsnlBoolean 

ValAsnl Integer 

ValAsnlUInteger 

ValAsnlOctet 

ValAsnlTimeticks 

ValAsnlGauge 

ValAsnl Counter 

ValAsnl I pAddr ess 

ValAsnlNull 

ValAsnlOid 

ValLogicalld 



1 

2 
3 
4 
5 
6 
7 
8 
9 

10 
11 
12 



45 



SO 
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// 

//. The following union defines all possible attribute types 

//in the EMS. 

// 

union Att rvalue switch (AttrType ) { 



case Vallnstld: 
case ValAsnlBoolean: 
case ValAsnllnteger : 
case ValAsnlUInteger: 
case ValAsnlOctet: 
case ValAsnlTimeticks: 
case ValAsnlGauge : 



Instld 

AsnlBoolean 

Asnllnteger 

AsnlUInteger 

AsnlOctet 

As nlTime ticks 

As nl Gauge 



instld; 

asnlBoolean; 

asnllnteger; 

asnlUInteger; 

asnlOctet ; 

asnlTimeticks; 

asnlGauge ; 
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case ValAsnlCounter : AsniCounter asnlCounter; 
case ValAsnllpAddress : Asnl IpAddress asnllpAddress ; 
case ValAsnlNull: AsnlNull asnlNull; 

case ValAsnlOid: AsnlOid asnlOid; 

case ValLogicalld: Logicalld logicalld; 

) ; 
// 

// each set of updates on a managed object is delivered 
// as a sequence of attribute- value pairs (SeqAttrCodeValue) . 
// 

struct AttrCodeValue { 

AttrCode code; 
AttrValue value; 

) ; 

15 typedef sequence<AttrCodeV*alue> SeqAttrCodeValue; 

// 

// The getAttrlnfo method of the MO returns a sequence of 
// information that describes each available attribute. 
// 

struct Attrlnfo { 

AttrCode code; 

AttrType type; // note: currently not 

populated 

AsnlOctet name; 

25 } ; 

typedef sequence<AttrInf o> SeqAttrlnfo; 
// 

// Config update notifications (via the deliverConf ig method 



20 



30 



40 



SO 



in the 



// ConfigCB) can take two forms. 

// 1) One or more managed object instances have been 

created . 

// ( CON FI G_C REATE ) . 

35 // 2) One or more managed object instances have been 

deleted 

// <CONFIG_DELETE) . 

// 

en urn Conf igNotif yType { 

CON FI G_C REATE , // a new MO instance has been created 
CONFIG_DELETE // an existing MO instance has been 
deleted. 

); 

// 

45 // Status update notifications (via the deliverStatus method 



in the* 

either 
from 

change 



// StatusCB) can take two forms. 

// 1) An initial update (STATUS_INIT) that is returned 

// as a result of a getStatus or as the initial status 

// a startUpdate request. 

// 2) An inremental update ( STATU S_CHANGE) representing a 



55 
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30 



40 



SO 



// to one or more of the attributes that the client 

registered for. 
// 

enuiti StatusNotif yType { 

STATUS_INIT, // represents initial status update of 



all 

startUpdate) 
update 

} ; 



// requested attributes (e.g. 

STATU S_CHANGE // represents an incremental status 

// (contains only att tributes that have 
/ / changed) . 



is // 

// each ccnfig update notification will be delivered as a 
sequence of : 

// network element instance id 

// managed object key list (sequence of attr- 

value pairs) 

// managed object instance id 

struct ConfigData { 

Instrd nelnst; 
SeqAttrCodeValue keyList; 
Instld molnst; 

25 ) ; 

typedef sequence<ConfigData> SeqConf igData ; 

// 

// viewConfigO - obtain EMS view of the current managed 

ob j ect 

// configuration for a specified network element 

instance. 

// The special value Anylnstance may be used to obtain 

// configuration information for all network elements 

as known 

// to the EMS. 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

/ / used to validate client permission to 

perform 

// the operation. 

// nelnst - specific NE instance identifier, or 

Anylnstance 

// to get config for all NE instances. 

45 // RETURNS: 

_ // A sequence of configuration information (sequence 

length 

// is proportional to the number of configured MO 

instances ) . 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_ I NVALI D_AP P_ I D 

// EM_INVALID_INST_ID 

55 // 



BNSDOCID: <EP 099807 6A1 I > 



16 



EP 0 998 076 A1 



15 



20 



SeqConf igData viewConf ig ( in SessionAppId sessionAppId, 

in Instld nelnst) 
raises ( EmapiException) ; 

5 // 

// noti f yConf ig ( ) - Client registration for managed object 
// configuration information for specified network 

element 

// instance (or the Anylnstance to register for 

io notifications 

// on all network element instances) . The current 

snapshot 

// of configuration is returned (like viewConfig) and all 

// subsequent configuration changes result in an 

invocation of 

// the specified callback. 

// 

// INPUTS : 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// nelnst - specific NE instance identifier, or 

Anylnstance 

// to get config for all NE instances. 

25 // callback - client callback (implements the 

Conf igCB 

// interface) that will be invoked for 

all 

// config changes . 

30 // RETURNS: 

// a sequence of configuration information (sequence 

length 

// is proportional to the number of configured MO 

instances ) . 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 
// EM_INVALID_INST_ID 
40 II 

SeqConf igData notif yConf ig ( in SessionAppId sessionAppId, 

in Instld nelnst, 
in ConfigCB callback) 
raises (EmapiException) ; 



35 



45 



50 



55 



II 

-■// cancelNotify <) - Cancel all requests for configuration 

change 

// notifications associated with the specified client 

application. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 
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// the operation. 

// RETURNS: 
/ / void 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM INVALID APP ID 

// " ~ 

void cancelNotify { in SessionAppId sessionAppId) 
10 raises { Emapi Exception ) ; 

// 

// getPersistent() - Obtain the attribute codes for all 
persistent 

ts // attributes maintained by this managed object. 

Persistent 

/ / attributes are those that the EMS keeps the current 

value 

// regardless of client registrations. Other attributes 

are 

20 f f polled for only when a client makes a request or 

registers 

// for update notifications. 

// INPUTS: 

tf sessionAppId - client session/application identifier. 

This is 

/ / used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// a sequence of attribute codes representing the 

persistent 

// attributes. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM__INVALID_SESSION_ID 
// EM INVALID APP ID 

// ~ 

SeqAttrCode getPersis tent (in SessionAppId sessionAppId) 

raises ( Emapi Except ion) ; 

40 // 

// getAttrSpec ( ) - Return identification of attributes that 

are 

// defined for the specific managed object instance. A 

sequence 

4S . M containing the attribute name (an OCTET representing 

the 

// ASCII string name) and the associated attribute code 

// is returned. 

// 

// INPUTS: 

50 tf sessionAppId - client session/application identifier. 

This is 

/ / used to validate client permission to 

perform 

/ / the operation. 

55 // RETURNS: 
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// A sequence of attribute info representing the 

attribute names and codes. 
// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSlON_ID 
// EM_ I NVAL I D_A P P_ I D 

// 

SeqAttrlnfo getAttrSpec (in SessionAppId sessionAppId) 

raises ( Emapi Exception ) ; 



// 

// getKeySpecO - Return identification of key attributes. A 

sequence 

// of attribute codes representing the keys is returned. 

Note 

// that the sequence will be in the order defined in the 

// MOview. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

25 // A sequence of attribute codes. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
30 // EM_INVALID_APP_ID 

// 

SeqAttrCode getKeySpec {in SessionAppId sessionAppId) 

raises ( EmapiException ) ; 



// 

// viewStatus() - obtain EMS "view" of the values of the 
specified 

// persistent attributes. 

// INPUTS: 

// sessionAppId - client session/application identifier. 

40 This is 

// used to validate client permission to 

perform 

// the operation. 

// instld ' - MO instance. This specifies the MO 



whose 



be 



// attributes are to be examined. 

.-// attrList - sequence of attribute codes that are to 



// viewed. 
// RETURNS: 

so // a sequence of attribute code/value pairs representing 



the 



// current view of the attribute values, 

// CALLER MUST DELETE RETURNED MEMORY. 

// 



55 
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// THROWS: 

// EM_INVALID_SESSION_ID 
/ / EM_INVALI D_AP P_I D 

/ / EM_INVALI D_I NST_I V 

5 // EM_ I NVAL I D_MO_I D 

// EM_ I NVAL I D_ATT R CODE 

// 

SeqAttrCodeValue viewStatus ( in SessionAppId sessionAppId, 

in Instld instld, 
10 in SeqAttrCode attrList) 

raises (EmapiException) ; 

// 

// getStatus () - request for a snapshot of current status 
// information. This differs from viewStatus in that 

attrList 

// may specify any managed object attribute codes, and 

the 

// information is returned via client callback. The 

callback is 

// used because the request may require a get request to 

the 

// network element. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// " used to validate client permission to 

perform 

// the operation. 

// instld - MO instance. This specifies the MO 

30 attributes are to be examined. 

// attrList - sequence of attribute codes that are to 

be 

// retrieved. 
// RETURNS: 
// void 
// 

// THROWS: 

/ / EM_INVALI D_S ESS I ON I D 

// EM_INVALID_APP_ID 
// EM_INVALID_INST_ID 
40 // EM_INVALID_MO_ID 

// EM_INVALID_ATTR_CODE 
// 

void getStatus ^in SessionAppId sessionAppId, 
in Instld instld, 
4S in SeqAttrCode attrList, 

in StatusCB callback) 
raises (EmapiException) ; 

// 

// startUpdate ( ) - client registration for notifications of 
SO // any updates to the values of the specified set of 

attributes . 

// An initial snapshot of all requested attributes is 

// delivered first ( type=STATUS_INIT) followed by 

notifications 

55 
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// of only those attributes that have changed 

{ t y p e = S TATU S _CHANG E ) 

// Note that this method may result in polling to the 

5 network 

// element, but only if the attributes are not persistent 

and 

// no other clients have issued a startlfpdate for the 

attributes (only a single poll is used for all 
registered 
10 // clients). 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

per form 

// the operation. 

// instld - MO instance. This specifies the MO 

whose attributes are to be examined, 
// attrList - sequence of attribute codes that are to 

20 be 

// monitored. 
// RETURNS: 
// void 
// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_I NVAL I D_AP P _ I D 

// EM_INVALID_INST_ID 
/ / EM_I NVALI D_MO_ I D 

// EM__INVALID_ATTR_CODE 
30 // 

void startUpdate ( in SessionAppId sessionAppId, 
in Instld instld, 
in SeqAttrCode attrList, 
in StatusCB callback) 
raises (Emapi Exception) ; 
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Cancel 
client 
number 
this 



// 

// stopUpdate{) - client deregistration for status updates. 
// all monitoring activity associated with the specified 

// application. Note that the client may have issued a 

// of startUpdate requests for different instances, but 

// single call to stopUpdate will cancel all of those 



requests . 

-// 
// INPUTS: 

// sessionAppId - client session/ application identifier. 

This is 

so // used to validate client permission to 

per form 

// the operation. 

// RETURNS: 
// " void 

55 // 
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// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_INVALID_APP_ID 

void stopUpdate (in SessionAppId sessionAppId) 
raises (EmapiException) ; 

// 

// getlnstO - return the instance identifier associated with 

the 

io // specified keys. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation* 

// nelnst - the network element instance identifier 

of the 

// NE that contains the managed object 

20 instance 

// specified by the keys. 

// RETURNS: 

// the Instld of the managed object, or Nulllnstance if 

not found. 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
/ / EM_I NVAL I D_AP P_I D 

// EM_INVALID_INST_ID 
// 

Instld getlnst(in SessionAppId sessionAppId, 
in Instld nelnst, 
in SeqAttrCode Value keyValues) 
raises (EmapiException) ; 

} ; 

35 

// 

// client callback for managed object configuration reporting 

// 

interface ConfigCB { 

oneway void deliverConf ig (in ClassCode classld, 

in MO: : Conf igNotif yType type, 
in MO: : SeqConf igData config); 

)'> 
// 

// client callback for managed object status reporting 
// 

interface StatusCB { 

oneway void deliverStatus (in Oid oid, 

in MO: : StatusNotif yType tv P e ' 
in MO: : SeqAttrCodeValue 

50 attrValList) ; 

}; 

// network element level managed object 
interface NEMO : MO { 

55 
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// attribute code reserved for boolean network element 

// isolation indication. 

const AttrCode IsolatedCode = i; 

// 

// each network level configuration " update notification is 
delivered 

// as a sequence of: 

// network element instance id 

// network element logical id 

struct NEconf igData { 

Instld instld; 

Logicalld logicalld; 

) ; 

typedef sequence<NEconf igData> SeqNEconf igData ; 
// 

// Sequence of containment information describing all 

// contained managed objects. 

// 

struct Containmentlnfo { 

ClassCode classCode; 
MO moRef; 
AsnlOctet name; 

}; 

typedef sequence<Containment!nf o> SeqContainmentlnf o; 



// 

// viewNEconf ig ( ) - obtain EMS view of current network element 
// configuration 

30 // 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// Sequence of network element configuration information. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

40 // THROWS: 

/ / EM_INVALI D_S ES SION_ID 

// EM_INVALID_APP_ID 

// 

SeqNEconf igData viewNEconf ig ( in SessionAppId sessionAppId) 

raises (EmapiException) ; 

45 

" // 

// notif yNEconf ig ( ) - client registration for network level 
// managed object configuration. An initial snapshot of 

// the network element level configuration is returned. 

50 // All subsequent changes to the network element 

configuration are delivered via the specified callback. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

55 
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// used to validate client permission to 

perform 

// the operation. 

// callback - callback object that is to receive 

delivery 

// of changes to configuration. 

// RETURNS: 

// Sequence of network element configuration information. 

// CALLER MUST DELETE RETURNED MEMORY. 

// 

// THROWS: 

/ / EM_I NVALI D_S ESSI ON_I D 

// EM_INVALID_APP__ID 
// 

is SeqNEconfigData notif yNEconfig (in SessionAppld sessionAppId, 

in NEconfigCB callback) 
raises (EmapiException) ; 

// 

2Q // cancelNEnotif y ( ) - cancel request for NE configuration 

change notifications 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

25 // used to validate client permission to 

perform 

// the operation. 

// RETURNS: 
// void 
// 

// THROWS: 
// EM_INVALID_SESSION ID 

// EM_INVALID_APP_ID 

// 

void cancelNEnotif y ( in SessionAppId sessionAppId) 
35 raises (EmapiException) ; 

// 

// getNEInst() - return the network element instance 
identifier 

// associated with the specified NE logical identifier. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

This is 

// used to validate client permission to 

45 perform 

_// the operation. 

// logicalld - the logical identifier (integer) of 

the network element. 

// RETURNS: 

// the Instld of the network element instance, or 

Nulllnstance 

// if not found. 

// 

// THROWS: 

/ / EM_INVALI D_S ESS ION_ID 

SS //EM INVALID APP ID 
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It 

Instld getNEinst (in Sess ionAppId sessicnAppId, 
in Logicalld iogicalld) 
raises ( EmapiException) ; 

// 

// getLogicalld ( ) - return the NE logical identifier 

// associated with the specified instance identifier. 

// 

io ft INPUTS: 

// nelnst - the instance identifier of the network 

element . 

// 

// RETURNS: 

// the logical identifier of the network element 

instance, 

// or 0 if not found. 

// 

Asnllnteger getLogicalld (in Instld nelnst); 

20 ff 

ft getContainment ( ) - return sequence with containment 
information 

// for this network element. The sequence returned 

contains 

2S ft the name, class code and a pointer to the associated 

service 

// class object. 

// 

// INPUTS: 

// sessionAppId - client session/application identifier. 

30 This is 

// used to validate client permission to 

perform 

// the operation. 

// RETURNS: 

// a sequence of containment information describing the 

contained 

// managed objects. 

// CALLER MUST DELETE RETURNED MEMORY . 

// 

// THROWS: 

40 ff EM_INVALID_SESSION_ID 

/ / EM_INVALI D_AP P_I D 

// 

SeqContainmentXnfo getContainment (in SessionAppId 
sessionAppId) 

raises ( Emapi Exception) ; 
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) ; 



// client callback for network element level managed object 
configuration 
// reporting 
interface NEconfigCB { 

oneway void deli verNEconf ig < in ClassCode classld, 

in NEMO: : Conf igNoti f yType type, 
in NEMO: : SeqNEconf igData conf ig) ; 

55 J ; 
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/ / typedefs for acknowledgement value & alarm level 
typedef Asnllnteger AckValue; 
typedef Asnllnteger AlarmLevel; 

//no alarm filtering conjunctions are permitted, but we do allow a 
single 

// filter to extract all alarmed notifications by defining an "out-of- 
band" 

// alarm level 

const AlarmLevel Any Alarm = -1; 



// typedef for event data structure — note that instance information 
may no 

75 // longer be valid when an event is processed, so key information 

should 

// always be available in the attribute-value list 
s t ruct EventData { 

Class Code class Code ; 

MO: :SeqAttrCodeValue seqVal; 

) ; 

typedef sequence<EventData> SeqEventData; 



// event distributor interface description 
interface EvtDist { 
25 // time of event as reported by EMS 

typedef long EventTime; 

/ / categories of events 
enum Category { 

ANY_EVENT, 
ALARM_CLEAR, 
ALARM_SET, 
CMD_ACK, 
CMD_RESP, 
CON FI G_CHANGE , 
35 INFO_MSG, 

INIT_MSG, 
STATE_CHANGE f 
NUM_CATEGORI ES 

J ; 

40 // event header (not all members valid for all categories) 

struct Header { 

EventTime e ventTime ; 

Category category; 

Old networkElemld; 
45 AlarmLevel networkElemAlm; 

Oid maintUnitld; 

AlarmLevel maintUnitldAlm; 

Cmdld cmdld; 

}; 

// event filter (not all members valid for all categories) 
struct Filter { 

Category category; 

Oid networkElemld; 

AlarmLevel networkElemAlm; 
55 Oid maintUnitld; 
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AlarraLevel main tUni t IdAlm; 

Cmdld cmdld; 

J ; 

5 // cookie for client registration/deregist ration 

typedef long Filterld; 

// client registration for events 
// 

10 // INPUTS: 

// id: SesionAppId associated with the filter 

// filter: EvtDist :: Filter that specifies filter 

criteria 

// callback: EventCB that defines deliverEvent ( ) 

// operation that will be called when an 

// incoming event matches the filter 

// RETURNS: 

// unique Filterld for this filter 

// 

// THROWS: 

20 // EMJtNVALID_SESSION_ID 

// EM_INVALID_APP_ID 
// EM_ I NVAL I D_CAT EGO R Y 

Filterld regis terFilter ( in SessionAppId id, 

in Filter filter, 
in EventCB callback) 
raises (Emapi Except ion) ; 



15 



25 



35 



// client filter deregis tration 

// 

// INPUTS: 

30 // id: SesionAppId associated with the filter 

// to be cancelled 

// filterld: Filterld of the filter to be cancelled 

// 

// THROWS: 

// EM_INVALID_SESSION_ID 
// EM_I NVALI D_AP P_I D 

/ / EM_INVALI D_FI LTER_I D 

void cancelFilter (in SessionAppId id, 

in Filterld filterld) 
raises (Emapi Except ion) ; 

40 ) ; 

// client callback for event notification 
interface EventCB { 

// deliverEvent ( ) is called by event distribution 
// software whenever an incoming event matches 
" // a registered filter. 
// 

// INPUTS: 

// header: EvtDist :: Header associated with the 

so f f incoming event 

// data: SeqEventData (sequence of event data) 

// associated with the incoming 

// event 
// 

55 oneway void deliverEvent (in EvtDist :: Header header, 
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in SeqEventData data) ; 

// This empty operation is called during event filter 

// auditing to determine whether or not the associated 

// session/application is still active. If it has 

// terminated, a CORBA: : Sy s temExcept ion will be thrown 

// and subsequently caught, indicating that the associated 

// filter should be removed from the filter queue. 

w oneway void checkO; 

\ ; 

// typedefs for alarm data structures 
struct AlazmRecord { 

15 Instld instld; // unique per alarm 

definition 

MO: : SeqAttrCodeValue attrValList; 

I; 

typedef sequence<AlarmRecord> SeqAlarmRecord; 

20 struct AlarmData ( 

ClassCode alarmDef; 
SeqAlarmRecord alarmRecords ; 

}; 

typedef sequence<AlarmData> SeqAlarmData; 

25 // alarm notification type 

enum AlarmNotif yType { AIARM_SET, ALARM_CLEAR } ; 

// active alarm manager interface description 
interface AlarmManager { 

// active alarm filter—note that logical ids are specified 

since 

// instance information may not be available at the time 
alarms are 

// reported 
struct AlarmFilter { 

ClassCode alarmDef; 
Logicalld networkElemld; 
ClassCode maintUnitClass; 
SeqLogicalld maintUnitld; 
AlarmLevel alarmLevel ; 

40 ) ; 

// client registration for active alarms — both initial data & 

update 

// notifications (note that only one alarm filter can be 
registered 

//with the alarm manager by each client application) 
SeqAlarmData requestAlarms (in SessionAppId sessionAppId, 

in AlarmFilter filter, 
in AlarmCB callback) 
raises ( Emapi Except! on ) ; 

so 

// request to change filter criteria (note that only one alarm 

filter 

// can be registered with the alarm manager by each client 
application) 

55 SeqAlarmData changeFilter ( in SessionAppId sessionAppId, 
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in AlarmFilter filter) 
raises ( Emapi Except ion) ; 

// request to refresh alarm list—returns snapshot of current 

// (note that only one alarm filter can be registered with the 



// manager by each client application) 

SeqAlarmData ref reshAlarms ( in SessionAppId sessionAppId) 
10 raises ( Emapi Exception) ; 



to the 



// client deregistration — cancel alarm set & clear forwarding 



// specified client application (note that only one alarm 
filter can 

// be registered with the alarm manager by each client 
application) 

void cancelAlarras ( in SessionAppId sessionAppId) 
raises ( EmapiException) ; 

// request for a list of all alarms in the entire system or 
20 associated 

// with the indicated network element — supports the EMS 
version of the 

// "OP : ALARM" technician command 

CmdSeqNo opAlarmdn SessionAppId sessionAppId, 
in ClassCode alarmDef, 
in Logicalld networkElemld, 
in EventCB ackCB, 
in EventCB cmdRespCB) 
raises (EmapiException) ; 

) ; 



// client callback for active alarm notification 
interface AlarrnCB { 

oneway void deli verAlarms ( in AlarmNotif yType type, 

in AlarmData data) ; 

J ; 

// active alarms service object interface, derived from managed object 
// interface — note that no filtering of active alarms can be specified 
interface ActiveAlarms : MO { 

// system client (e.g., Active Alarm Manager) registration for 
// active alarms — both initial data and update notifications 
SeqAlarmRecord getAlarms {in SessionAppId sessionAppId, 

in AlarmCB callback) 
raises (EmapiException) ; 

// system client (e.g., Active Alarm Manager) deregistration — 
..// cancel active alarms update notifications 

void cancelAlarms (in SessionAppId sessionAppId) 
raises (EmapiException) ; 
) ; 

#endif // _EMAPI_IDL 
// EOF // 
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APPENDIX B-GLOSSARY 

Alarm The description of an alarmed notification. 

Attribute 
Attribute Code 



Class Code 

Configuration 
Information 



CORBA 
EMAPI 
EMS 
Event 

Instance Identifier 



A property of a managed object (e.g. alarm state). 

An integer value which uniquely identifies an attribute of a given managed 
object. 

An integer value which uniquely identifies a managed object class 

Generic term which has one of two meanings depending on its context; 

With respect to a managed object class, this term applies to the identification 
of all instances of the class, either for a specific network element or for all 
network elements in the system. 

With respect to a managed object instance, this term may apply to one or 
more attributes which are associated with database values, such as the 
primary/alternate role of a duplex component. 

Common Object Request Broker Architecture 

Element Management Application Programming Interface 

Element Management System 

The description of a spontaneous occurrence, such as alarm notification, 
command acknowledgment or configuration change. 

An integer value which uniquely identifies an instance of a given managed 
object. 



Interface Operation Generic term for distributed service request. The target method may be 

defined in the Element Management Application Programming Interface (e.g. 
status registration) or in an application-specific derivation of a managed 
object (e.g. command execution). 



Logical Identifier 

Managed Object 
ORB 

Object Identifier 



An integer value which represents the logical number of a device or interface 
(e.g. AP 4). Note that there is no direct correlation between a logical id and 
instance id. 

An abstract representation of a physical or logical resource which may be 
managed by the EMS (e.g. network element, maintenance unit, data link). 

Object Request Broker 

The combination of managed object class code and instance identifier which 
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10 



uniquely identifies any managed object instance in the system. 

Persistent Attribute Information stored and kept current irrespective of any client request (e.g. 
maintenance state). 

Service Object Any EM Server object which provides services to client applications. 

Session Each client must establish a session at initialization—for which a unique 

session identifier is assigned—that will be used to validate access permissions, 
to correlate client requests and to keep track of Server resources utilized in 
behalf of any applications associated with the session. 

*s Status Information Current attribute values for a managed object instance. 



Claims 

1. In a network having a controllable network element, a method for controlling the network element from a remote 
work station connectable to the network, comprising the steps of: 



registering the network element for attributes to be tracked; and 

polling for attributes associated with the network element only if the client requests the monitoring of the net- 
work element. 

2. The method of claim 1 wherein the polling is performed by the server. 

3. The method of claim 1 including the step of reporting changes in attributes when the client requests notification of 
changes in attributes. 

4. The method of claim 1 , including the steps of 
polling for the attributes for a plurality of clients, and 

reporting changes in the attributes to one of the plurality of clients requesting notification of changes in the 
attributes. 

5. The method of claim 4 wherein the step of polling includes the step of polling once for a plurality of clients that 
registers for the same attributes. 

6. The method of claim 5 including reporting asynchronously changes in the attributes to a plurality of clients. 

7. The method of claim 1 wherein the step of polling is performed in a single polling cycle when multiple clients have 
registered for the same attributes. 

8. The method of claim 7 including the steps of 

running an object oriented program at the remote work station to control an object associated with the con- 
trollable network element; 

translating interface operations generated by the work station during the running of the object oriented program 
55 to corresponding translated interface operations in an object oriented language associated with the object 

being controlled; and 

connecting the corresponding translated interface operations through the network to an object server to control 
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the object associated with the network element in accordance with the translated interface operations. 

9. The method of claim 8 in which step of translating includes the steps of 

s automatically determining which of a plurality of different object oriented languages is the object oriented lan- 

guage of the object being controlled, and 

generating translated interface operations corresponding to the interface operations from the remote worksta- 
tion to the object server in accordance with the language of the object being controlled as has been automat- 
ic ically determined. 

10. The method of claim 8 in which the object oriented program run at the remote work station is a JAVA program. 

1 1 . The method of claim 8 in which the network element is located at a node of the network and the step of translating 
? 5 includes the step of 

receiving the interface operations through a communication link of the network at a node separate from the 
node of the network element, 

20 translating the interface operation through the network communication link into the corresponding translated 

interface operations by converting the received interface operations into IPC and TCP/IP requests. 

12. The method of claim 11 in which the step of connecting includes the step of transmitting the IPC and TCP/IP 
requests to the object server. 

25 

1 3. The method of claim 1 2 in which the step of connecting includes the step of generating the IPC and TCP/IP request 
through a web-based GUI. 

14. The method of claim 8 in which the object server responds to the translated object requests by 

gathering information concerning the network element, and conveying the information concerning the network 
node that has been gathered to the remote work station by at least by one of the ways of 

dynamically generating a web-page visual display associated with the network element being controlled for 
35 interfacing with the remote work station to display the gathered information. 

15. The method of claim 14 in which the step of gathering includes the step of gathering network element information 
concerning at least one of the items of network element information of 

40 a list of all active alarms, 

a summary of system alarms, and 

a detailed indication of the status of the network element. 

45 

16. The method of claim 15 in which the step of gathering includes the step of selectively gathering all of the items of 
information. 

17. The method of claim 8 in which the step of translating includes the step of communication with the object server 
so through a distributed object request architecture to provide a consistent interface to the managed object that hides 

implementation details associated with the object manager. 

18. The method of claim 17 in which the distributed object request architecture is CORBA architecture. 

55 19. The method of claim 8 in which the CORBA architecture functions as an IPC for functions residing on the object 
server to eliminate the need for platform specific language for the object oriented program at the remote station. 

20. The method of claim 8 in which the CORBA architecture functions as an IPC for functions residing on the object 



30 



32 



BNSDOCID: <EP 0998076A1 I > 



EP 0 998 076 A1 



server to provide for distribution of functionality to multiple work station processors. 

21 . The method of claim 8 in which communication between the network element and the object server is through use 
of a network management protocol 

5 

22. The method of claim 1 wherein the network management protocol is the simple network management protocol. 

23. The method of claim 21 including the step of obtaining system status associated with the network element by 
polling and auditing pursuant to the simple network management protocol. 

w 

24. The method of claim 21 including the step of providing real-time notification of alarm conditions at the network 
element through the use of network management protocol event manager 

25. The method of claim 21 including the step of providing command and control signals to the network element through 
is use of simple network management protocol set operation. 

26. The method of claim 8 in which 

the object server is part of an element management server that also includes a web server, and including the 
20 step of 

displaying command and alarm output information from the network element as a web browser-based display 
through use of the web server. t 

25 27. The method of claim 26 in which 

the element management server also includes an executive control processor, and including the step of 

sending the command and alarm output information Irom the network element that is displayed through use 
so of the web server to the executive control processor. 

28. The method of claim 1 2 including the steps of 

storing network element information concerning the network at the element management server and 

35 

selectively providing the stored network element information to a plurality of different work stations. 

29. The method of claim 8 including the step of sending from the network element event and alarm notifications to the 
object server through use of a network management protocol. 

40 

30. The method of claim 29 including the step of issuing commands from the network element to obtain input information 
from the work station running the object oriented program to the object server through the use of the network 
management protocol. 
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